home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / ab20 / ab20_archive / fish / aquarium / aquarium-581-590.lzh / Update.doc < prev   
Text File  |  1992-02-29  |  8KB  |  204 lines
  1.      _______________________________________________________________
  2.     |                                |
  3.     |             Aquarium Database Update            |
  4.     |            Fred Fish Disks 581 - 590            |
  5.     |              21st Revision             |
  6.     |_______________________________________________________________|
  7.  
  8.  
  9.  
  10. What have we got here?
  11.  
  12. This distribution contains the portion of the Aquarium Database which, when
  13. appended to the previous, packed, version of the database, will bring it up
  14. to date to include all disks through Fred Fish's AmigaLibDisk #590. 
  15.  
  16. It is extremely important that you observe the following points:
  17.  
  18.       -    Your present Aquarium Database contains disks 001 - 580.
  19.  
  20.       -    Your present Aquarium Database is in the packed format
  21.     as described in the 15th Revision of these distributions.
  22.     If you don't know what the h*** I'm talking about then
  23.     don't use this update!
  24.  
  25.       -    You append an update set only if it is exactly sequential,
  26.     meaning that if you have 001 - 550 you shall NOT append
  27.     the 581 - 590 set before having applied the 551 - 580 set.
  28.  
  29.       -    You use a backup copy of the files data, index, KeyNames, and
  30.     Names.  I'm anything but infallible; protect yourself!
  31.  
  32.  
  33.  
  34. Floppy Users
  35.  
  36. Since the database continues to grow towards the limits of floppy disk
  37. space, you will sooner or later run of of space.  The instructions
  38. below assume (for simplicity's sake) that enough space is available.
  39. If you do encounter a problem with diskspace, use the RAM: disk to
  40. store the .lzh file and the extracted -add files. 
  41.     Notice also that you could simply rename the .new files after
  42. they've been created with join and relabel the volume to AQUARIUM: and
  43. using the original AQUARIUM: disk as a backup to fall back on. 
  44.  
  45.     NOTE: I am not the author of Aquarium; I have no source.
  46.           The author of Aquarium is B Lennart Olsson.
  47.  
  48.  
  49.  
  50. Physical/Logical Volume assumptions (substitute your own if you want):
  51.  
  52. I will refer to two volumes in this documentation, NEWFISH and
  53. AQUARIUM.  On a floppy disk, this would refer to two distinct disks,
  54. named appropriately, while on a harddisk you may have these assigned
  55. to different directories or partitions. 
  56.     I don't supply you with a script to automate the update, since
  57. I have rarely run across a script that will work with every
  58. environment and takes everything into account.  Your human
  59. intelligence is far more capable than my assumptions and a script's
  60. limitations.
  61.     If I get feedback on it, I'll try my luck on a script, of
  62. course. 
  63.  
  64. Synopsis:
  65.     NEWFISH:    the AquariumData*.lzh file you wish to add.
  66.     AQUARIUM:    the Aquarium program and the data/ directory. 
  67.  
  68.  
  69.  
  70. Installation Instructions
  71.  
  72. At the CLI, enter (the stuff in italics)
  73.  
  74.     1> cd NEWFISH:
  75.     1> lharc x AquariumData*
  76.  
  77. At this point, LHARC will extract the various files from the archive,
  78. placing them all into the current directory (NEWFISH:).
  79.  
  80. Next, enter the following commands.  These will join the original file
  81. with the newly extracted additions, and save the results in a file
  82. with the extension .new
  83.  
  84.     1> join AQUARIUM:data NEWFISH:data-add as NEWFISH:data.new
  85.     1> join AQUARIUM:index NEWFISH:index-add as NEWFISH:index.new
  86.     1> join AQUARIUM:names NEWFISH:names-add as NEWFISH:names.new
  87.  
  88. You can now delete the extracted additions and copy the .new files
  89. over the old version of the database.  Notice that if you perform this
  90. step on your only copy of the Aquarium, you lose the option of undoing
  91. the addition if it should prove faulty.  Be careful!
  92.  
  93.     1> delete NEWFISH:data-add NEWFISH:index-add NEWFISH:names-add
  94.     1> copy NEWFISH:data.new AQUARIUM:data
  95.     1> copy NEWFISH:index.new AQUARIUM:index
  96.     1> copy NEWFISH:names.new AQUARIUM:names
  97.  
  98. Voilá!
  99.  
  100.  
  101.  
  102. Patching Aquarium
  103.  
  104. ATTENTION: I provide this patch as a matter of extending the lifespan
  105. of Aquarium for users without harddisks until a more permanent
  106. solution can be found.  I can take no responsibility for problems of
  107. any kind that arise from applying this patch. 
  108.     I am also unsure if B Lennart Olsson would approve of altering
  109. his program.  I certainly failed to get permission.  Don't hit me!
  110.  
  111. ATTENTION: This patch will not help you unless you have two floppy
  112.            drives (or more).  Aquarium keeps the data, index, and names
  113.            files open during its operation.  If you have only one floppy
  114.            drive, you'd quickly go insane swapping disks ...
  115.  
  116. WARNING:  Make these modifications on a COPY OF THE AQUARIUM PROGRAM.
  117.           Don't say I didn't warn you!!
  118.  
  119. Ok, down to business:
  120.     Luckily, Aquarium stores a full relative path to all its data
  121. files, and we can modify these so long as we don't use up any more
  122. space than already taken (this is a safety measure).
  123.     Using NewZap, you will find that Aquarium is 97 "sectors" long.
  124. Each sector is 512 bytes.  On sector 93, you will find a sequence of
  125. bytes similar to the following rather inaccurate representation:
  126.  
  127. ASQ  CNPTNF data/index    data/data        data/names      data/keynames
  128.  
  129. It appears that the string "CNPTNF" is unique up to that point, so you
  130. can use that to locate this region within the executable.  There is
  131. another area within the executable which has names such as
  132. "data/names" etc.  That area has a lot of "r+" symbols mixed in with
  133. the file names.  Leave that region alone; it is not the one we want. 
  134.  
  135. What we need to pay attention to are the names of the four data files:
  136.     data/index
  137.     data/data
  138.     data/names
  139.     data/keynames
  140.  
  141. We will change ONLY THE "data/" portion of these, making them either
  142. "FSH1:" or "FSH2:"
  143.     FSH1:index
  144.     FSH2:data
  145.     FSH1:names
  146.     FSH1:keynames
  147.  
  148. Notice that ONLY the file "data" will be stored on FSH2: because that
  149. one is the biggest file and will reside by itself on an otherwise
  150. blank disk. 
  151.  
  152. Make sure you tell NewZap to SAVE the modifications!  Exit the program.
  153.  
  154. You will now have to prepare two new floppy disks.  Label them FSH1
  155. and FSH2 (use the relabel command or rename blank (freshly formatted)
  156. disks from the Workbench).  Make sure there is no Trashcan folder on
  157. the disk.
  158.     Store the file "data" on FSH2
  159.     Store the other files (even the Aquarium executable) on FSH1
  160.  
  161. Notice that you do NOT want to store the files in subdirectories any
  162. longer.  Store the files in the root of the respective volume.  You
  163. need no data/ directory any more since we patched Aquarium to use a
  164. logical volume name instead.
  165.  
  166. Now, when you run Aquarium (from FSH1) Intuition will ask you to insert
  167. volume FSH2 or FSH1 as required.
  168.  
  169.  
  170.  
  171. KingFisher:  The Aquarium rewrite
  172.  
  173. What little time I have these days is going into KingFisher, which aims to
  174. be not only visually pleasing but offers a lot of number of new features.
  175. I'm sorry to say that this is taking far longer than expected, but working
  176. for a living and enjoying life a lot does keep me away from my Amiga too
  177. much to make quick progress. 
  178.     Rest assured that the Usenet community will be informed when
  179. KingFisher is ready for release.  I am hoping that I may make it by April
  180. 1992 ...
  181.  
  182.  
  183.  
  184. Many Thanks ...
  185.  
  186. I'd like to thank Fred Fish for his continuing efforts to provide us, the
  187. Amiga community, with an organized collection of freely distributable
  188. software.  590 Disks!!! Amazing!  Go Fred, Go!
  189.  
  190. I would also like to express my thanks to B. Lennart Olsson, who made
  191. available to us the Aquarium (Aqvarium?) for all those Fish Disks!  Beats
  192. the h*** out of searching huge text files!
  193.  
  194. Ian Nicholls of Australia, savior of time and space :-), receives my
  195. special thanks for the aqua* utilities.
  196.  
  197. And last, but not least, all those who write all that freely distributable
  198. software deserve our special thanks.  Where would we all be without YOU?
  199.  
  200.                  ___
  201.  ._.  Udo Schuermann        / | \    "There is no Way to Peace.
  202.  ( )  walrus@wam.umd.edu    \/|\/     Peace is the Way!"  -- Ghandi.
  203.                  ~~~
  204.